home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / sfmovtrv.zip / SFMOVTRV.DOC < prev    next >
Text File  |  1990-06-11  |  17KB  |  389 lines
  1.                                  
  2.                                 SFMOVTRV
  3.                        SPITFIRE MOVIE TRIVIA DOOR
  4.                               Version 2.0
  5.                                    by
  6.                              Rowland Halliday
  7.  
  8.                                                              
  9.     
  10.     
  11.    INTRODUCTION
  12.    ------------
  13.                          
  14.       SFMOVTRV is a fast paced movie trivia game designed to run
  15.    as a door feature within the SPITFIRE Bulletin Board System.  It can
  16.    also be installed as a sysop configurable command from the Main, File
  17.    or Message menus of SPITFIRE.  A data file containing over 400 movie 
  18.    trivia questions is randomly accessed and displayed to the screen.  
  19.    With each question that is displayed, four multiple choice options 
  20.    are provided from which the player may select.  SFMOVTRV allows the 
  21.    player ten seconds to read the question and respond with the number 
  22.    corresponding to the answer they wish to select.
  23.     
  24.     
  25.    SFMOVTRV SETUP AS A SPITFIRE DOOR
  26.    ---------------------------------
  27.     
  28.       To set up SFMOVTRV to be executed as a door, it is recommended that
  29.    a separate directory be set up for it.  For explanation purposes, let's
  30.    assume the directory DOORA is created for use with SFMOVTRV.  The following
  31.    files must then be placed in the directory:
  32.    
  33.    SFMOVTRV.EXE    The actual game program.
  34.    
  35.    SFMOVTRV.DAT    The data file containing the trivia questions.
  36.    
  37.    SFMOVTRV.TOP    This is a listing of the top ten players.  SFMOVTRV.EXE
  38.                    will create this file if it is not found. 
  39.                    
  40.    SFMOVTRV.LMT    This allows you to set time limits according to the
  41.                    callers security level.
  42.    
  43.    The Sysop will then need to use a text editor to edit the SF.BAT file   
  44.    as illustrated below:
  45.    
  46.    :DOOR_A
  47.    COPY SFDOORS.DAT C:\SF\DOORA
  48.    SFMOVTRV
  49.    ERASE SFDOORS.DAT
  50.    GOTO LOOP
  51.    :DOOR_B
  52.      
  53.    You will notice that the commands needed to execute SFMOVTRV are placed
  54.    between the :DOOR_A and GOTO LOOP command lines.  These are entered in
  55.    place of the existing REM Place Program Name Here.  The following will 
  56.    briefly explain each of the commands which were set up within SF.BAT to 
  57.    run SFMOVTRV as a SPITFIRE Door program:
  58.    
  59.       SFDOORS.DAT is created automatically by SPITFIRE when a user enters a
  60.    door.  It contains information about the user such as name and password.
  61.    SFMOVTRV requires access to the information within SFDOORS.DAT.  Therefore,
  62.    before executing the program it must be copied to the directory in which
  63.    SFMOVTRV is running.  
  64.    
  65.       SFMOVTRV is the program name and executes the game program from within
  66.    the door program.
  67.    
  68.       Once the user has terminated the game play of SFMOVTRV, SPITFIRE
  69.    erases the SFDOORS.DAT file.
  70.    
  71.    
  72.    
  73.    SFMOVTRV SETUP AS A SYSOP CONFIGURABLE COMMAND
  74.    ----------------------------------------------
  75.  
  76.       SPITFIRE has a sysop configurable command for the Main, Message and
  77.    File menus.  The sysop configurable command is executed through a
  78.    batch file which corresponds to the menu it is being run from.  In
  79.    other words, SFMAIN.BAT runs the sysop configurable command from
  80.    the Main Menu, SFMESS.BAT runs the one from the Message Menu and
  81.    SFFILE.BAT the one from the File Menu.  The commands necessary
  82.    to execute SFMOVTRV can be set up in the batch file which corresponds
  83.    to the menu you wish to have SFMOVTRV run from.
  84.  
  85.       The first thing you will need to establish is which of these menus
  86.    you wish to use to run SFMOVTRV.  For this purpose, let's assume that
  87.    it is going to be set up so it can be run from the Main Menu.  (It
  88.    should be noted the set up procedure is the same regardless of which
  89.    Menu you are running SFMOVTRV from.)
  90.  
  91.       Next, you will need to decide what you wish to name the command
  92.    option and establish what security level will be required for
  93.    users of your system to be able to access this option.  Once this
  94.    is determined you will need to modify the SFMAIN.MNU file using
  95.    your favorite text editor, as long as it saves in ASCII format.
  96.    (Refer to the SPITFIRE manual for further documentation on this
  97.    if needed.  It should also be noted that if SFMOVTRV were being
  98.    set up to run from the File Menu, you would need to modify the
  99.    SFFILE.MNU file and if it was being set up to be run from the
  100.    Message Menu you would need to modify the SFMSG.MNU file.)
  101.  
  102.  
  103.       Examining the default SFMAIN.MNU file, you will notice the sysop
  104.    configurable command appears as:
  105.  
  106.         <K>............. Add Your Own,,1000,@
  107.  
  108.  
  109.       This will need to be replaced with a Command Character that will
  110.    be used to select the option from the menu.  It is ASOLUTELY IMPERATIVE
  111.    that the Command Character must not duplicate an existing Command
  112.    Character for another menu option.  You will then need to include
  113.    a brief description of the Wildcat door program you are running, two
  114.    commas, the security level required to access this feature, and another
  115.    comma followed by the a @.  The @ must not be changed! (For more detailed
  116.    information on modifying your SFMAIN.MNU, SFMSG.MNU or SFFILE.MNU refer
  117.    to your SPITFIRE manual.)
  118.     
  119.        <K>.... Brief Program Description,,10,@
  120.  
  121.       Now you will need to modify the corresponding batch file, SFMAIN.BAT,
  122.    so that it can be executed from the Main Menu.  Do this using your
  123.    favorite text editor, as long as it saves in ASCII format.  (Again, it
  124.    should be noted that if SFMOVTRV were being set up to run from the File
  125.    Menu, you would need to modify the SFFILE.BAT file and if it was being
  126.    set up to be run from the Message Menu you would need to modify the
  127.    SFMESS.BAT file.)
  128.  
  129.       Place the SFMOVTRV.EXE file in the directory you wish to run the
  130.    program from.  SFMOVTRV will create its own player score file,
  131.    SFMOVTRV.TOP, if does not already exist.
  132.  
  133.       The commands set up in the SFMAIN.BAT file are very similar to
  134.    those used for executing the game through a door in the SF.BAT file.
  135.    For instance, if you were running SFMOVTRV from the main SPITFIRE
  136.    directory your SFMAIN.BAT file might look like this:
  137.  
  138.        ECHO OFF
  139.        BRK OFF
  140.        SFMOVTRV
  141.        BRK ON
  142.  
  143.       (BRK is not included in the SFMOVTRV package because it is written
  144.    and copyrighted by Solid Systems, 1985, but can be downloaded from
  145.    The Mother Board BBS and Buffalo Creek's BBS as well as a number of 
  146.    other BBS systems.  BRK is not required to run SFMOVTRV, however, it 
  147.    is recommended since it will prevent a user using the CTRL BRK command 
  148.    to terminate the batch file, gaining access to your system at the 
  149.    DOS level.)
  150.  
  151.       If you wish to set SFMOVTRV up in a separate subdirectory from
  152.    SPITFIRE, for instance, a subdirectory named SFMOVTRV, your batch
  153.    file might look like this.
  154.  
  155.        ECHO OFF
  156.        BRK OFF
  157.        COPY SFMAIN.DAT \SF\SFMOVTRV
  158.        CD \SF\SFMOVTRV
  159.        SFMOVTRV
  160.        ERASE SFMAIN.DAT
  161.        CD \SF
  162.        BRK ON
  163.  
  164.  
  165.       When SFMOVTRV is executed, from either the door with the SF.BAT file
  166.    or from the sysop configurable command through a menu with the
  167.    corresponding batch file, it will first look for the SFMAIN.DAT file,
  168.    then the SFMESS.DAT file, then the SFFILE.DAT file and lastly the
  169.    SFDOORS.DAT file.  It will look for each of these files until it finds
  170.    it and the commands required for its execution.  If none of these
  171.    files are found, SFMOVTRV will halt its execution.
  172.    
  173.   
  174.    MOVIE TRIVIA HIGH SCORE BULLETINS
  175.    ----------------------------------
  176.    
  177.       An command line parameter is available which will automatically
  178.    create Ansi and Non-Ansi high score bulletins for your BBS system.  
  179.    If you would like to use this option, a "/P" should follow the 
  180.    SFMOVTRV in the command line to indicate a valid DOS path where the 
  181.    bulletin file will be created.   (NOTE:  This should be the same
  182.    as the display file path you have set up within SPITFIRE.)  The path 
  183.    is then followed by the file name of the bulletin to be created.  It 
  184.    is not necessary to include the file extension.  SFMOVTRV will 
  185.    automatically add a .BBS extension for the Non-Ansi display file and 
  186.    a .CLR extension for the Ansi display file created.  The correct 
  187.    syntax should look like this:
  188.    
  189.    SFMOVTRV /P C:\SF\DISPLAY\DORBUL1
  190.    
  191.    The "/P" command line is optional and SFMOVTRV will operate perfectly
  192.    fine without it.  However, it is a convenient means of providing and 
  193.    posting high score bulletins for the movie trivia door.
  194.    
  195.  
  196.    LOCAL PLAY OF SFMOVTRV
  197.    ----------------------
  198.  
  199.       It should also be noted that a Sysop can play SFMOVTRV locally by       
  200.    entering the following command at the DOS prompt:
  201.    
  202.    C:> SFMOVTRV /L
  203.  
  204.     
  205.     ** SPECIAL NOTE **  The "/L" and the "/P" command parameters can
  206.     be used together in one command line to specify the drive, path
  207.     and filename of the bulletin to be created when playing in
  208.     local mode.
  209.  
  210.    
  211.    SFMOVTRV ON A MULTI-NODE SYSTEM
  212.    -------------------------------
  213.    
  214.       SFMOVTRV is fully compatible for operation on a multi-node BBS.
  215.    It automatically handles any file locking and file sharing 
  216.    required during the doors execution.   
  217.  
  218.  
  219.    DTE LOCK FEATURE
  220.    ----------------
  221.  
  222.       SFMOVTRV automatically detects if the DTE is locked at 19200 baud.  If
  223.    SFMOVTRV detects that the DTE is locked, then SFMOVTRV opens the serial
  224.    port to the maximum baud rate of your system.  If SFMOVTRV does not 
  225.    detect that the DTE is locked, then the serial port is opened to the
  226.    baud rate of the caller.
  227.    
  228.  
  229.    SYSOP FEATURES
  230.    --------------
  231.    
  232.        First, a status line is now displayed on the BBS monitor that 
  233.    provides information concerning the caller's name, baud rate of the 
  234.    caller and the security level of the caller.     
  235.    
  236.       A SFMOVTRV.LMT file allows the sysop to establish a time limit for 
  237.    door play according to the security level the caller has on the system.  
  238.    To modify the accompanying SFMOVTRV.LMT file, use your favorite text 
  239.    editor to represent the various security levels you have available on 
  240.    your system, a comma then the corresponding time you wish to allow for 
  241.    that particular security level in minutes.  For instance, it might 
  242.    look like this:
  243.    
  244.    10,15
  245.    25,20
  246.    50,25
  247.    999,30
  248.    
  249.    Each security level should begin a new line and you should have a
  250.    setting for each security level you have available on your system.
  251.    If you do not have a time limit set for a particular security 
  252.    SFMOVTRV will default to the level 10 security level setting.
  253.    
  254.       Pressing the Shift Key and the F1 key simultaneously will 
  255.    terminate game play of SFMOVTRV and return the caller back to the
  256.    BBS.  Pressing the Shift Key and the F9 key simultaneously will
  257.    terminate game play of SFMOVTRV and log the caller off of the BBS.
  258.    If the Shift Key and the F9 key are pressed together, logging the
  259.    caller off the BBS, SPITFIRE will recycle and return to the
  260.    SPITFIRE Ready For Caller Prompt.   
  261.             
  262.  
  263.    SFMOVTRV EXECUTION
  264.    ------------------
  265.       
  266.       When first executed, SFMOVTRV will display a list of the Top Ten 
  267.    high score players and the percentage of correct responses they acheived
  268.    while playing SFMOVTRV.  Initially, this will be a dummy listing with
  269.    ten lines that display:
  270.    
  271.       0%...............YOUR NAME COULD BE HERE
  272.       
  273.    However, as the game is played, this will fill with the name of the
  274.    players, their percentage ratings and the date that the player was
  275.    added to the top ten listing.  
  276.    
  277.    NOTE: At least twenty questions must be attempted before SFMOVTRV will
  278.          will figure the percentage rating for the player.
  279.          
  280.    To keep things interesting...the Sysop can erase the file which contains
  281.    the top ten listings SFMOVTRV.TOP on a routine basis to give additional
  282.    players a chance to have their name added to the list.
  283.    
  284.    As the top ten list is displayed, at the bottom of the screen  is a
  285.    question which prompts the user whether they want to have ANSI Graphics
  286.    (y/n)? available to them during game play.  If the user responds with a
  287.    y (for yes) the game will display in color and if the user responds with
  288.    a n (for no) the game will display in monochrome.
  289.    
  290.    
  291.   
  292.    PLAYING SFMOVTRV
  293.    ----------------
  294.   
  295.       Immediately after pressing any key (other than <Q> for Quit) from 
  296.    the Top Ten listing the game screen is displayed.  The screen will
  297.    look like the following:
  298.       
  299.    ------------------------------------------------------------------------
  300.  
  301.     ╔═════════════════════════════════════════════╗
  302.     ║   >>>>>>>>>>>> MOVIE  TRIVIA <<<<<<<<<<<<   ║
  303.     ║                 Version 2.0                 ║
  304.     ║   Movie Trivia Game For SPITFIRE BBS Doors  ║
  305.     ║          HAPCUG  BBS (904) 257-1029         ║
  306.     ║ In Cooperation with Buffalo Creek Software  ║
  307.     ║ Copyright (C) by Rowland Halliday, 1989,90  ║
  308.     ║       UNREGISTERED SHAREWARE VERSION!       ║
  309.     ╚═════════════════════════════════════════════╝
  310.        
  311.     RIGHT: 0                        WRONG: 0
  312.      
  313.     QUESTION:
  314.     The movie trivia question will be displayed
  315.     here.
  316.     
  317.     <1> Choice 1                        <2> Choice 2
  318.     <3> Choice 3                        <4> Choice 4
  319.     
  320.              Enter Answer: [ 1 2 3 4 <Q>uit]?
  321.                        
  322.    -----------------------------------------------------------------------
  323.    
  324.    The first randomly choosen trivia question is selected from the data
  325.    file and is displayed to the screen. 
  326.    
  327.       The player makes his selection by entering the corresponding number.
  328.    As the game progresses, SFMOVTRV will provide a running total of the
  329.    correct answers and also of the wrong answers the user has selected
  330.    during the game play.
  331.  
  332.    If the ten second timer should elapse before you respond, SFMOVTRV 
  333.    will count this as a wrong response and add an incorrect answer to 
  334.    the total WRONG answers obtained so far.
  335.            
  336.  
  337.    EXITING PLAY
  338.    ------------
  339.    
  340.       When you are ready to exit the game, simply select press "Q" for
  341.    <Q>uit.  If you qualify as one of the top ten players to date, 
  342.    SFMOVTRV will congratulate you for becoming one of the top ten scorers
  343.    and add your name to the Top Ten listing.  You will once again see the 
  344.    Top Ten list displayed with your name added to the list.  
  345.    
  346.      If you exit the game before you have completed the twenty
  347.    questions required for eligibility to the Top Ten list or if you do not
  348.    qualify as a Top Ten player, the Top Ten listing will be displayed and 
  349.    you will be prompted to press any key to return to SPITFIRE.
  350.    
  351.    
  352.    DISTRIBUTION
  353.    ------------
  354.      
  355.       Please feel free to share SFMOVTRV.ZIP with others.  However, it must
  356.    be distributed with SFMOVTRV.EXE, SFMOVTRV.DAT, SFMOVTRV.TOP and the 
  357.    SFMOVTRV.DOC in the SFMOVTRV.ZIP distribution package.  These files must 
  358.    not be altered in any way or by any means.
  359.    
  360.          SFMOVTRV.ZIP is distributed as Shareware software.  You are free to
  361.    try SFMOVTRV, and if you find it to be a program you use please send the
  362.    required $10.00 fee to:
  363.    
  364.                           Rowland Halliday   
  365.                           415 Mobile Avenue
  366.                           Daytona Beach, Florida  32018
  367.  
  368.                              
  369.    DISCLAIMER
  370.    ----------
  371.    
  372.       Rowland Halliday shall not be held responsible for any damage incurred
  373.    by the user to hardware, software, or peripheral devices while running
  374.    SFMOVTRV.  All responsibility lies in the user of the software.   
  375.    
  376.    
  377.       Many thanks are indeed owed to Mike Woltz of Buffalo Creek BBS (515)-
  378.    225-8496 for his assistance.  Without his help this program would not
  379.    have been possible.   
  380.    
  381.  
  382.    SFMOVTRV and other SPITFIRE programs are available for download from:
  383.    
  384.     Buffalo Creek BBS     Halifax Area PC Users Group   The Mother Board BBS
  385.     Sysop - Mike Woltz     Sysop - Rowland Halliday    Sysop - Jacque Shipley
  386.       (515) 225-8496           (904) 257-1029              (515) 986-3445
  387.    19200/9600/2400/1200           2400/1200                9600/2400/1200
  388.  
  389.